xlwingsで最終行番号を取得する－Sheet.used

「xlwings 最終行」 といった検索で時折アクセスがあります。

表計算ソフトExcelを操作するPythonの外部ライブラリxlwingsを使って、ワークシートの最終行を取得するにはどのようなコードを書けばいいのかを調べていた方による検索です。

「最終行」と表現されているのが何なのかいくつかの解釈が可能ですが、この記事ではSheetオブジェクトのused_rangeプロパティ、Rangeオブジェクトのlast_cellプロパティを使って、最終行番号を取得するサンプルをご紹介します。

以下のスクリプトを実行してください。

bk = xw.Book() ws = bk.sheets[0]

ws['B2:G5'].value = 123

新規ブックがExcelで表示され、B2:G5セルに数値「123」が入力され、最終行番号である「5」が出力されます。

もちろんポイントは、

の行、print()関数の引数に指定された「ws.used_range.last_cell.row」です。

最終行番号を出力している、

の「.used_range」は、Sheetオブジェクトのused_rangeプロパティです。 Excel VBAのWorksheet.UsedRangeに相当するプロパティで、ワークシート上で使われているセル範囲を表すRangeオブジェクトを取得できます。

先ほどのスクリプトを実行した後に、

を実行すると、

と出力されます。

先のスクリプトでは、

と、B2:G5セルのみに値を入力しているので、Sheet.used_rangeは、B2:G5セルですから、「ws.used_range.address」で「$B$2:$G$5」が取得できるわけです。

最終行番号を出力している行

の「.last_cell」は、xlwingsのRangeオブジェクトに用意されているlast_cellプロパティです。

セル範囲を表すコレクションとしてのRangeの、最後のセルを表すRangeオブジェクトを取得するための、便利なプロパティです。

Excel VBAで、何らかのセル範囲の最後のセルを表すRangeを取得する場合、セルの個数をRange.Itemプロパティの引数に指定する必要があります。

xlwingsでは、Range.last_cellプロパティを使うだけで最後のセルを表すRangeを取得でき、とても便利だと感じます。

先ほどのスクリプトで最終行番号を出力している行

の「.row」は、Rangeオブジェクトのrowプロパティです。 Excel VBAのRange.Rowに相当するプロパティで、行番号を返してくれます。

Home » Python » xlwingsの使い方 » xlwingsで最終行番号を取得する－Sheet.used_range.last_cell.row